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The machine configuration is as follows: 

Conf i gurati on 





















OCD 


MSA 








OCD 












OC 






WSA 


IA 


Wide Store 

32K 

64-bit 


IB 




Mathilda 
64-bit 
IK CS 


Rikke 
16-bit 

2K CS 




OA 


OB 


IA 


MainStore 
32K 
16-bit 




OA 






OB 






IB 




IB 








OB 














1 ,| 











fig- 1.1. 

Both Rikke and Mathilda are connected to a 32K 64-bit memory cal- 
led Wi deStore(WS) . Data is transferred between Rikke an WS through 
8 16-bits dataports, 4 for reading and 4 for writing, where a 
special wr i teoperat i on from Rikke allows writing of individual 
16-bit groups in WS C6H. 

Data is transferred between Mathilda and WS through 2 64-bits 
dataports. 



WS is controlled through OC/OCD-ports on Rikke, and 
WSA/OCD-ports on Mathilda, details are given in C6D . 



th rough 



Rikke and Mathilda can communicate directly through 2 16-bits 
dataports IB/OB. 

Rikke is furthermore connected to a 32K 16-bits local memory cal- 
led MainStore through IA/OA, where MSA is the address register. 

The drawing in figure 1.1 does not represent the full physical 
Ri kke/Mathi Ida system. Rikke is also connected to other 
I/O-devices, such as TTY, lineprinter, papertape and D i sk- cont ro l- 
ler, and the DEC-1 0-sy stem, but for the purpose of this paper 
these are left out. 



Z' Ib.£ mic rogro^ram . 



2-1- Pregarat i on . 

Preparation of a microprogram for Rikke or Mathilda is done using 
the assemblers and simulators on the DEC-10 C1 3 . 

The following example shows how to get the binary microprogram to 
the Rikke file-system. 

Assuming the DEC-10-file ADD.LUI is a source file of a micropro- 
gram for Mathilda: 
The assembler will produce 2 files: 

ADD. LPT : a listning of the program 
ADD.PTP : the binary microprogram 

If the program is to be simulated on the DEC-10 instead of actual- 
ly executed on Mathilda, the assembler will produce the file 
ADD.MTS instead of ADD.PTP. 

To be executed on Mathilda, the file ADD.PTP must now be transpor- 
ted to the Rikke file-system, where it must reside in a directory 
with the extension .MAT ( e.g under the name ADD. MAT ) C23. 
This can be done in two ways: 

1. Punch the file on the DEC-10 papertape puncher, and use the 
command 'readptr ADD. MAT' to read it into a directory on 
Rikke. 

2. Use the transmission-system between DEC-10 and Rikke to 
transmit the file. The transport must be initiated on both 
machines : 

on Rikke : readdec ADD. MAT 

on DEC-10 : copy RIKOUT: = ADD.PTP/I 

The "/I" after ADD.PTP is neccessary because of the DEC-10 
file-format for binary files, and because the transmission 
system can be used to send text-files too. 

So we have: 



ADD.LUI 
assemb ler / \ 

ADD. LPT ADD.PTP 



DEC-10 



I 

v 
ADD. MAT 



f i le-t ransmission 
Ri kke 



If the file is a microprogram for Rikke, it must be given the ex- 
tension .MIC on Rikke. 
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2-2- Structure of the mj crogrognam- 

The communication between a BCPL- program and a user microprogram 
can be done through the Library functions, described in the next 
sect i ons : 

This standard communication demands the parameters to be setup in 
a vector, pvec, and has the following conventions about entry and 
exit from the user microprogram: 

At entry: 

LRCLRP] = pvec, the address of the parameter vector 
DS = pvec!0 , 1- parameter 
VS = pvecM , 2. parameter 

At ex it : 

DS = result, the contents of DS is written back 

to the caller 
RB+1 must be used to return from the microprogram. 

This indicates, that the value of RBP before 

exit must be the same as at entry, so the RB- 

stack must be used carefully. 

The RA-stack can be used freely. 

Origin: 

To avoid overwriting of system-microcode the origins for user 

microprograms must be greater than: 

on Rikke : 1024 (decimal), 400 (hexadecimal) 
on Mathilda : 100 (decimal), 64 (hexadecimal) 

An example of a microprogram for Mathilda that obeys these rules 
is the following ADD.LUI: 



LOUISE VERSION 1.7. PDP-10 17 OCTOBER 1980 
LINEN0 CS ADDRESS 



ADD.LUI 



PAGE 1 



• lie********************************************************** 
.ADD: PROGRAM TO ADD 2 INTEGERS 
. 3-9-80 FLEMMING WIBR0E 

•RADIX = 16 
•ORIGIN = 109 




1 
2 
3 
4 
5 
6 
7 
8 
9 
10 

11 : 

12: *********•**•••**•*•****••**•**********•************••**••** 

13: 

14: *ENTRY=ADD 



109 ADD: 
10A 
10B 
10C 



LR:=DS ; ALF:=A+B 
AS:=VS ; 
DS:=AL ; 



; . 1 PARAMETER 

; . 2 PARAMETER 

; . DS=RESULT 

;RB+1 . RETURN 



2.2 
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5- 53i££22£29I!3mmi ng Rikke. 



A microprogram can either be Loaded and called under control from 
a user BCPL-prog ram, or from an interactive system-program- The 
interactive execution will be described in section C5U, here we 
describe how to handle a microprogram from a user BCPL-prog ram . 

The way in which microprograms are executed, differs somewhat on 

Rikke and Mathilda, primarily because Rikke is host for 

I/O-nucleus and the OCODE-mac h i ne, and secondarily because of the 

difference in datapath-width, 16-bit for Rikke and 6 4- bit for 

Mathilda. 

We start by describing how to run a microprogram on Rikke. 

3-1- BCPL- library, functions.. 

The library is named "RCSLi b.R EL" and is located in directory 
">SysAdmin>SysUser>Ri kCS", together with the GET-file 
"Ri kHdr .GET". These 2 files must be linked to Cur rent Di re ct ory 
before use . 

RCSLib contains the following functions: 

SetupRi kkeC S [silence] 
LoadRi kkeCSCf i lenameU 
DefineRikkeEntryCentry,offset] 
Ca I IRi kkeCSCent ry,pvec3 
Reset Ri kkeEnt ry Cent ry] 
ResetRi kkeCSCU 

RikHdr.GET contains the globals corresponding to these functions, 
200-210, and the manifests used to communicate the results of the 
functions. 

sstyEBilsls^csEiiisQP.^ 

This routine must be called before any load of microcode to 
initiate system-tables etc. The value of silence must be 
NOSILENCE or SILENCE. If s i len ce=SI LEN CE, the warnings reported 
by any of the routines in RCSLib will be suppressed. The errors 
detected by any of the routines will always be reported regard- 
less of si lence . 

LoadRikkeCSCf n3 

A function, which loads the microcode on file fn.MIC in Current- 
Directory. If the microprogram contains any V ALUE-statement s, 
these will be executed by LoadRikkeCS. 
The result of the function is: 



N0TF0UND : fn.MIC is not in Cur rent D i r e ct ory . 
N0G00D : an overwrite of existing microcode was attempted, 

3.1 



else 



or format-error, sum-error or EOF on fn.MIC. 

an entry-point 'entry', which can be used by 
CaLLRikkeCSCentry,pvec3 



In any of the two first cases, LoadRikkeCS displays an ap- 
propiate message on the console before returning. 

In the current assembler C1 1 it is only possible to specify one 
entrypoint by ,f *ENTRY = nn" . If, in a large microprogram, an al- 
ternative entrypoints is desired, this function can be used to 
define a new entrypoint to be nn+offset. 

The result of Def ineRi k keEnt ry is: 

N0G00D 



else 



offset does not specify an entrypoint insi- 
de the microprogram, referenced by 'entry' 

as LoadRikkeCS. 



£al iRikkeGSCent r^,g\/ecD 

Calls the microcode, identified by 'entry*. pvec is the address 

of a communication-area in WideStore, which must be allocated 

from the calling BCPL-program . 

pvecli must contain the i'th parameter to the microprogram 

C2.2]. 

The result of CaLLRikkeCS is 

N0G00D : 'entry' does not identify a loaded microprogram 

else the result of the microprogram, i.e the contents 
of DS upon exit. 

B§§££Ei]<keEntrxCentrx] 

If 'entry' is the result from LoadRi kkeCSCf n3, this routine 
discards the microcode, specified by 'entry', i.e disables cal- 
ling of the microcode and allows loading of new microcode in the 
same ControlStore locations. 

ResgiBikkeCS 1111 

Discards all loaded microcode. 
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3.2- Examgle. 

The following is an example of a program, which can load and call 
the program ADD. MIA. This program is a Rikke equivalent of ADD.LUI 
C2.2], 

RIKADD.BCPL: 



get "SysHdr 1 
get "RikHdr' 

mani f est 



$( NUMBPARAMS 



2 $) 



// BCPL-library 

// microcode library 



let StartO be 

$(S 

let add, pvec, res = 0,0,0 
LoadC'RCSLib", Cur rent Directory] 

// initiate BC PL/ mi c r ocode communication: 
SetupRikkeCSCNOSILENCE] 

// load the microcode: 
add:=LoadRikkeCSlI"ADD"] 
switch on add into 
$(sw 

case N0TF0UND : 

case N0G00D : G i vellpC " I oad aborted"] 
endcase 



/ / load the I i brary 



// load ADD. MIC 



default 
$)sw 



: endcase 



// loaded ok 



/ / initiate pvec : 
pvec:=NewVecCNUMBPARAMS-1 1 
pvec !0 : = Prompt NC "1 . operand - "] 
pvec ! 1 : = Pr ompt NC"2 . operand - "] 

// pe rf orm call: 

res:=CallRikkeCSCadd,pvec] 

if res = N0G00D then G i veUpCca I I aborted"] 

// display resu It : 

Out FCConsole, "result of %N+%N = % N*n", pve c ! , pvec ! 1 , res] 



$)S 



//' c lean up 

Ret urnVecC pvec, NUMB PAR AMS-1 ] 



The library RCSLib.REL is loaded by the program RIKADD.BCPL, but 
the load, add load, go construction, or the 'combine 1 program C2] 
could be used instead. 



3.2 
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2l-2- 51i£E2£2ded ki^H2£Z f.UQ££i2Qs. 

Mi crocoded Library functions can be used from a user microprogram 
via the XTERNAL declaration C1 1 . 

On Rikke 2 functions are available, the entry-points are specified 
in hexadecimal addresses: 

WSREAD = 21 : read a 16-bit word from WideStore. 
The address must be in AS, 
the result is on IB. 
Destroys: AS(15)S, IB, IBD/ ALF, OCD and OC. 

WSWRITE = 22 : write a 16-bit word to WideStore. 
The address -must be in AS, 
and the value to write in LRCLROPH. 
Destroys: AS(15)S, OB, OBD, OCD and OC. 

For both functions, the AS-address is a 16-bit-word address, as 
used by the OCODE-machi ne, so addresses passed as parameters from 
a BCPL-program can be used immediately ( remember WideStore is a 
64-bit memory). WSREAD and WSWRITE will do the actual conversions 
to 64-bit-word addresses and the selection of the correct port- 
number. 

This has as consequence, that WSREAD and WSWRITE only can be used 
in the 0C0DE- machines address-space, the lowest half of WideStore, 
64K 16-bits words, which equals 16K 64-bits words. 

Routines to access the upperhalf of WideStore must be supplied by 
the user microprograms. 

The routines are called as subroutines, using the RA-stack, e.g 

START: 

AS: = ... ; RA! , " ,,,,, ,,,,M " ; R-WSREAD 

CONTINUE: VS:=IB 



3.3 



4" Microprogramming Mathjlda.. 



The routines for Loading and calling a microprogram in Mathilda 
are basically identical to those of Rikke, however there are some 

differences due to; 

- the asy nc h rounous operation of the calling and 
the called processor 

- the difference in datapath-width 

Point 1 leads to a slightly different c al I i ng- seq uen ce, whereas 
point 2 gives some complications, when communicating parameters 
and results. 



4-1" BCPL- libra r^ functions. 

The library is named "MCSL i b . REL " and is located in directory 
">SysAdmin>SysUser>MatCS", together with the GET-file 
"Mat Hdr -GET". These 2 files must be linked to Cur rent Di rectory 
bef ore use. 

MCSLib contains the following functions: 

Set upMatCSCsi lence] 

LoadMat CSCf i lename] 

Def i neMatEnt ry Cent ry, of f set 3 

Mat ParVec Cn3 

SetMat Par Cpvec, i , v3, v2, v1 , vOD 

R eturnMatVecCpvecU 

CallMatCSCentry,pvec] 

ResetMatEnt ry Cent ryl 

ResetMatCSCD 

InMat64Cbuf3 

0utMat6ACbuf3 

MatDACD 

MatSACD 

MatDeadStartC: 

MatHdr.GET contains the globals corresponding to these functions, 
110-130, and the manifests used to communicate the results of the 
f unct i ons . 

Before communicating, Mathilda must be deadstarted, see C2H . The 
deadstart- loade r loads the boot s t r ap- I oader, and hands over con- 
trol to this. After normalising Mathilda, the boot st rap- loade r is 
ready to load and execute another microprogram. 
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Set ugMatCS [silence] 

The purpose of this routine is to initialise the communication 
between Rikke and Ma th i Ida, and to initialise the tables on Rik- 
ke administering the Mathilda Cont ro I Store - The value of silen- 
ce must be NOSILENCE or SILENCE. 
Before SetupMatCS is called, Mathilda must be deadstarted. 

To establish a communication between Rikke and Mathilda, a 
microprogrammed monitor, which can load and execute user micro- 
programs, must be loaded. SetupMatCS loads this communication 
moni t or . 

The monitor contains microprogrammed library functions as 
described in section 4.3, and assures, that the conventions for 
communication from section -2.2 are obeyed. The text of the cur- 
rent (27/10-80) communication monitor can be found in appendix 
B. 

As with SetupRi kkeCS, s i lence=SILENCE suppresses the warnings 
given by any of the routines in MCSLib, the errors are always 
reported. 

LoadMatCSCf nil 

A function, which loads the microcode on file fn.MAT in Current- 
Directory. If the microcode contains any V ALUE-statement s, these 
will be executed by LoadMatCS. 
The result of the function is: 

N0TF0UND : fn.MAT is not in Cur rentD i r e ct ory . 

N0600D : an overwrite of existing microcode was attempted, 
or format-error, sum-error or EOF on fn.MAT 

else an entry-point 'entry', which can be used by 
Ca UMatCSCent ry,pvec] 

In any of the two first cases, LoadMatCS displays an appropiate 
message on the console before returning. 

££f ineM at Entry [entry, of f set] 
equivalent to Def ineRi kkeEnt ry 

Mat ParVecCn] 

Delivers a vector, pvec, of size 4*n, such that pvec rem 4=0. 

SetMatParCp_vec,2/-v3,y2,y1_,yO] 
Equivalent to 

$( let k = (i-1)*4 

pvec! (k +3), pvec! (k+2),pvec! (k+1 ),pvec!k:=v3,v2,v1 ,v0 
$■) 

ReturnMatVec Cgyec] 

Returns the vector allocated by MatParVec. 
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CaLLMatCSCentrx/evecH 

CaLLs the microcode identified by 'entry', pvec is the address 
of the communication area in WideStore as seen from Rikke: 

Because of the difference in datapath-width on Rikke and Mathil- 
da, this communication- area is treated in a special way: 

1. Parameters are seen as 64-bits words from Mathilda, but 
must be handled as 4 16-bits words from Rikke. 

2. The address of a parameter is a 64-bits word address 
from Mathilda and a 16-bits address from Rikke, so 
ri kadd res s = 4*mat address . 

3. As a consequence of this, each parameter, which must be 
setup from Rikke, consists of 4 16-bits words, where the 
address of the first word must be divisible by 4. 

The call pvec:= Mat ParVec Cry] allocates a communication vector in 
WideStore of size 4*n, such that pvec rem 4=0. 
The pvec must now be initialised as follows: 

pvec!0 = bit 15. ..0 of 1. parameter 

pvec!1 = bit 31 . .1 6 of 1. parameter 

pvec!2 = bit 47. .32 of 1. parameter 

pvec!3 = bit 63. .48 of 1. parameter 



pvec!4 ... = bit 15. ..0 of 2. parameter 

pvec!5 = bit 31. .16 of 2. parameter 

pvec!6 = bit 47.-32 of 2 b parameter 

pvec!7 = bit 63.-48 of 2. parameter 

pvec!8 = bit 15. ..0 of 3. parameter 



After the call Ca I IMat CSCent ry, pvec], the conventions of section 
2.2 means that upon entry to the microprogram 



LR = pvec/4, 

DS = 1 .pa rameter : 

VS = 2 . parameter : 



the address of the parameter vector 
pvec!3::pvec!2: :pvec!1 : : pvec !0 
pvec!7: :pvec!6: :pvec!5: :pvec!4 



Cal IMat CSCent ry, pvec) does not wait for any result from the 

Mathilda microprogram, it merely starts execution and waits only 

for the Mathilda monitor to reply with an accept of the call to 

ensure that the microprogram is started, and then returns to the 

calling BCPL-program with the result ACCEPTED. 

The result from the microprogram, the content of DS, can then be 

obtained by calling InMat64. 

If 'entry' does not identify a loaded microprogram, or 

pvec rem 4 \=0, N0G00D is returned. 



4.1 
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If 'entry 1 is the result of LoadMat CSCf n3 , this routine discards 
the microcode, specified by 'entry 1 , i.e disables calling of the 
microcode and allows loading of new microcode in the same Con- 
trolStore locations. 

ResetMatGSn 

Discards all loaded microcode. 

lQMat64Cbuf: 

Reads a 64-bit words, send from Mathilda through the direct con- 
nection between Rikke and Mathilda, to the 4-word vector 'buf' 
such that : 



buf !0 
buf !1 
buf !2 
buf !3 



bit 15. -.0 

bit 31 ..16 

bit 47.-3 2 

bit 63. .48 



This routine is used after CallMatCS to wait for the result 
the Mathilda microprogram. 

Note: Mathilda sends the word in 4 * 16-bits, so 'buf 1 need 
be divisible by 4, as with pvec. 



of 



QutMat64Cbuf3 

Writes a 4*16-bits word to Mathilda through the direct connec- 
tion in the same format as InMat64. If Mathilda is not ready to 
read from Rikke, Rikke will be hung up. 

MatDACD 

A boolean functions, Mathilda Data Available, which is true, if 
Mathilda has send a word to Rikke through the direct connection, 
and Rikke has not read this value yet. 

MatSAC: 

A boolean function, Mathilda Space Available, which is true, if 
Mathilda has read the last word send from Rikke through the 
direct connection. 

MatDeadStartCH 

If Mathilda' is in a welldefined state after having executed a 
user microprogram, it can be deadstarted from a BCPL-program by 
calling this routine, i.e unload the communication monitor and 
the user microprograms, and return control to the bootstrap- 
loader . 



This routine 
BCPL-program. 



should be called upon normal exit from the user 
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4.2. Examgle. 

The following is an example of a program, which can load and call 
the program AD D . LUI C2 .2H . 

MATADD.BCPL: 



get "SysHdr" 
get "MatHdr" 

manifest $( NUMBPARAMS 



2 $) 



// BCPL-library 

// mi crocode library 



let Start () be 
$(S 

let add, res = 0,0 

and pvec = 

and buf = vec 3 

LoadC'MCSLib", Cur rent Directory] 

// initiate BCPL/mi c rocode communication: 
SetupMatCSCNOSILENCE] 



// load the li brary 



// load the microcode: 
add:=LoadMatCSC"ADD M ] 
switchon add into 
$ ( s w 

case N0TF0UND : 

case N0G00D : GiveUpC" load, aborted"} 
endcase 

def au It : end case 
$)sw 



// load ADD. MAT 



// loaded ok 



// initiate communication .area: 
pvec:=MatParVecCNUMBPARAMS3 

SetMatPar(pvec,1 , 0,0,1,0) 
SetMatPar (pvec, 2, 0,0,0,1) 



// a vector of size 8 

// 1 .par = 65536 
// 2. par = 1 



/ / perform call: 

res:=CallMatCSCadd,pvec] 

swi t chon res into 

$(sw 

case N0G00D : G i veUpC "ca I I aborted"] 

endcase 
case ACCEPTED : endcase // Mathilda started 

default : G i vellpC'system-er r.or"3/ /should not occur 
end case 

$)sw 
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// wait for Mathilda 

until MatDAC] do 

$( 

// Do some sensible work. This loop need not be here, 
// since InMat64 will. wait for Mathilda. 

$) 



// read the result 
InMat64(buf ) 



// the result i n * buf ■ 



// display result : 

ut FCC on sole," result : %U : :%U : :%U : :%U*n",buf ! 3, buf ! 2, buf ! 1 , buf ! 3 

// c lean up: 

R e t u r n M a t V e c ( p v e c ) 

MatDeadStartC] 



$)S 



4.2 
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4-3. Mi^rocgded Library functions. 

The following 4 functions are available in the standard com- 
munication monitor, and can be used from the user microprograms 
via the XTERNAL declaration- The addresses are given in hexa- 
decimal: 



WSREAD 



WSWRITE 



RIKREAD 



read a 64-bit word from WideStore. 
The address must be in AS, 
the result is on IB- 
Destroys: ALF, WSA, OCD, IA 

write a 64-bit word to WideStore. 
The address must be in AS, 
and the value to write in LRCLROPD. 
Destroys: ALF, WSA, OCD, OA 

read a full 64-bit word send from 

Rikke by 0utMat64. 

The result is on AL. 

Requires: LRIP=LR0P 

Destroys: CA, ALF, LRCLRP3, IB 



RIKWRITE 



write a full 64-bit word to Rikke, 
to be recieved by InMat64- 
The value to write must be in VS- 
Destroys: CA, VS, OB 



The AS-addresses for WSREAD and WSWRITE are 64-bits-word WideStore 
addresses, so these two functions can be used to access the whole 
Wi deStore • 

The routines are called as subroutines, using the RA-stack as 
described in section 3-3- 
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5- lD£§I§ctiye execution of a microp.rogr.am.. 



If the user only wants to Load and call a simple microprogram, i.e 
a program which only communicate with the calling BCPL-program and 
only give one value, a word, as its result, this can be done with 
the programs "Rikke" and "Mathilda". 

They consists of respectively "RCSLib" and "MCSLib" together with 
some input/output routines, and a microprogram catalog. 

The commands they accept are: 

load name : load a microprogram from file name. MIC (Rikke) 
or name. MAT (M-athi Ida) . 



call 



delete name 

list 
help 
end 



call of the microprogram 'name'. The program 
asks for the number of parameters and the 
parameters . 

For Rikke, the parameters can only be given in 
deci mal . 

For Mathilda they can be given as: 

e.g 



dec imal 
hexadec . 
octal 
binary 



102 16-bit 

XA7B42C 64-bit 

0713132 64-bit 

B101001 64-bit 



The result of the microcode call is displayed in 
decimal, and for Mathilda in hexadecimal too. 

discards the microprogram 'name 1 . If , name , =all 
all loaded microprograms are discarded. 

gives a list of all callable microprograms. 

type a help text on the Console. 

terminate the program. In case of Mathilda, a 
Mat DeadStart CD will be executed. 



The example-programs ADD. MIA and ADD.LUI can both be executed by 
these two programs. 

The two programs reside in SystemDi re ct ory, and are invoked as 
normal systemprograms by typing their name C2D . 
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6- Restrictions on microprograms. 



When running a microprogram on Rikke or Mathilda, some rules about 
the environment must be obeyed, especially on Rikke, since the 
I/O-nucleus and the OCODE-mac h i ne both are microprogrammed 
C33,C4H, and therefore (possibly) uses the same registers, masks 
etc. as the user microprogram. 

Both Rikke and Mathilda must be left in a normalised state, when 
the user microprogram terminates. This means: 



maco: = laco: = lbco: 

MAC1D = PAC1II = PBCO] 

MAP = LAP = LBP 

BSS = PGS = CM 

CUALF = A+B 



PA COD = NOMASK 

= FULLMASK 
PAP = PBP = 



(11 ...111) 
(00. ..000) 



If any of these are omitted, the processor ( Rikke or Mathilda) 
will probably die, when trying to execute the next microprogram, 
which on Rikke is the 0C0DE- machine itself. 

On the other hand, the user microprograms may also assume, that 
both Rikke and Mathilda are normalised, when entering the micro- 
program. 

On Mathilda a user microprogram can use all the resources in the 
machine, the register groups, pointers etc, with the exceptions as 
mentioned above, and assume that the values are unchanged, when 
re-entering the microprogram from the BCPL-system, except for the 
following, which are used by the library routines and the com- 
munication monitor: 



ALF 


CA 


CB 


LRP 


LRC13 


AS 


DS 


VS 


OC 


SA 


IB 


IB 


0A 


0B 




0CD 


WSA 









On Rikke the user microprograms are more restricted. The 

1/0-nucleus and the OCODE-ma ch ine uses some permanent resources, 

and these must not be changed by the user microprograms. These 
are : 



WAC03 : 
WAC113-WAC133 



the 0C0DE- machine registers 
used by 1/0-nucleus 



WBC0] : 0-15 = 0,1 ,2,3,, ,1 4,-1 , the constants 
WBC23 : used by the disk-controller 

WBC4D - WBC7] used for OCODE-de cod i ng 



MB:5-9 

MB:12-14 

LA:14-15, 



used by the disk-controller 

used by 1/0-nucleus and OCODE-mach i ne 

used by the OCODE-mach ine 



MainStore : 
MS: 0-256 
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used by I/0-nucLeus 



Apart from these, the 1/0-nucleus and the OCODE-mach i ne uses some 
resources, when running, so these cannot be assumed to be un- 
changed, when re-entering a user microprogram. The following 
resources are not used, and can be assumed to be left unchanged by 
the 1/0-nucleus and the OCODE-mach i ne : 



ALSG 


C53 - 


- C153 


BSSG 


C53 - 


- CI 53 


CASG 


C53 • 


- C153 


LA 


C53 ■ 


- CI 33 


MA 


C53 - 


- C153 


PA 


C53 ■ 


- C1 53 


PMSG 


C53 • 


- C153 


MSASGC53 ■ 


- C1 53 



AVDSG 


C53 - 


- C153 


BMSG 


C53 - 


- C153 


CBSG 


[53 - 


■ C153 


LB 


C53 ■ 


- C1 53 


MB 


C13 ■ 


- C43 


PB 


C53 • 


- C1 53 


PGSG 


C53 - 


- U53 


WB 


C83 - 


- C1 53 



The free W A- groups must not be used uncontrolled, since the 
1/0-nucleus also uses these for device-records. If a WA-group is 
needed, it must be allocated and deallocated by the calling 
BCPL-program: 



group := All ocDBC3 
DeAllocDBCgroup3 



// al locate 
// deallocate 



For both Rikke and Mathilda, using VALUE-s tatements on any of the 
above permanent resources or the resources concerning the nor- 
malised machine, will of course have disastrous consequences too. 

Furthermore it should be noted, that VALUE-statement s are executed 
by LoadRikCS and LoadMatCS, see 3.1 and 4.1, and that this ex- 
ecution uses some pointers and registers, when initialising the 
register-group and pointers. 

This means, that all the microcode for a user microprogram should 
be loaded, before calling any of the microcode, if the microcode 
assumes any register-group or pointer to be left unchanged by the 
BCPL-system. 
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C63 : J .K.Kj s rgaard 

The RIKKE-MATHILDA WideStore 
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Aggendix B: Mathilda moQi£o.L 



The following is the source text for the Mathilda communication 
monitor as of 27/10-80. The text, and thereby the addresses is 
likely to change in the future, but the functions should remain 
unchanged. 

The source text of the Rikke and Mathilda bootstrap loaders can be 
found in £13. 



LOUISE VERSION 



27 OCTOBER 1 980 12:38:53 



MATHILDA M I CR 0- PR 0G R AMS RUN-TIME ENVIRONMENT 



9-5-80 : MEMREAD,MEMWRITE: READ/WRITE DIRECTLY FROM WS 



CONTROLSTORE LOAD MODULE 
MATLOAD : 

NEWLOAD:AL 



RA 


= SB, 
= BUS 


SA:=SB 
RA ! 

CSLOAD 




R-READ 
R-READ 
R-READ 

SA 

IF CB 

R-READ 

R-NEWL 


THEN 
OAD 


RB + 1 


. START-ADDRESS 
.LOAD-COUNT 


; oc 
















SA + 1 





AND PARAMETER TRANSFER MODULE. 
TIVATION OF USER MI C R0- PROGRAMS 
OINTS TO THE PARAMETER VECTOR, 
ONTAINS THE 1 . PARAMETER 
ONTAIMS THE 2. PARAMETER 

TERMINATION OF A U SE R- S PE C I F I ED FIRMWARE FUNCTION 
CONTENTS OF DS IS AUTOMATICALLY 
TEN "BACK" TO THE CALLING SYSTEM ROUTINE, AS 

CONTENTS IS ASSUMED TO BE THE RESULT OF THE 



R-READ 




.START-ADDRESS 


R-READ 




.PARAMETER VECTOR 


R-WRITE 




.ACCEPT TO RIKKE 


R- ME MR E AD 




.1 .PARAMETER 


R-MEMRE AD 




.2. PARAMETER 


IF KA THEN 


HERE 




SA 




.EXECUTE PROGRAM 


R-WRITE 




.RESULT TO RIKKE 


R-EXEC 




.READY AGAIN 
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UISE VERSION 1.7. PDP-1D 27 OCTOBER 1 98C 



RARY' ROUTINES 



. 64 BIT WORD SEND FROM A BCPL PROGRAM ON RIKKE 



WRITE A FU 



BIT UORD TO A BCPL PROGRAM ON RIKKE 



WIDESTORE READ FUNCTION: I A : =WS C AS 3 



TE ROUTINE: WSCAS]:= 



OT OCSA THEN HERE 



IF IADA THEN RA + 1 ELSE HERE 



OCD:= 1 



0CA1, SETALFA 



HESE ROUTINES 



ABLE THROUGH A T Al 



108: 
109: 
110: 



RIKREAD : 
RIKWRITE: 
WSREAD: 
WSWRITE: 



R-READ 
R-WRITE 
R-MEMREAD 
R-MEMWRITE 



ASSEMBLY CORRECT 
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Running a microprogram on Rikke-Mathilda 

Micro Wibroe, Flemrning. 

Archives Running a microprogram on Rikke-Mathilda / 
U-30 Flemrning Wibroe. — Aarhus , Denmark: Com- 
puter Science Department, Aarhus Univer- 
sity, 1980. 

(DAIMI; MD-141) 



I. Title. 



